@njuptlzf/agent-chat-web 0.3.0 → 0.4.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/AgentChat.js CHANGED
@@ -3,6 +3,7 @@ import { createContext, useCallback, useContext, useEffect, useMemo, useRef, use
3
3
  import { ActionBarPrimitive, AuiIf, AssistantRuntimeProvider, ComposerPrimitive, MessagePrimitive, ThreadPrimitive, useAui, useAuiState, useLocalRuntime, useMessageTiming, } from "@assistant-ui/react";
4
4
  import { MarkdownTextPrimitive } from "@assistant-ui/react-markdown";
5
5
  import { createChatAdapter, dataUrlToImage, markEdit } from "./adapter.js";
6
+ import { emptyMembersState, reduceMembers } from "./ui/members.js";
6
7
  import { createFollowUpAdapter, followUpConfigOf, resolveFollowUpMode } from "./suggestions.js";
7
8
  import { docKind, docPart, fileToDoc, MAX_DOCS } from "./docs.js";
8
9
  import { auth } from "./auth.js";
@@ -23,6 +24,8 @@ export default function ChatApp({ branding, sessionId, initialMessages, tier, sc
23
24
  const [confirms, setConfirms] = useState([]);
24
25
  const [uiPrompts, setUiPrompts] = useState([]);
25
26
  const [notices, setNotices] = useState([]);
27
+ // 多 phase 成员卡片(W4):member_* / run_done 事件逐帧归集;档 1 恒为 emptyMembersState。
28
+ const [members, setMembers] = useState(emptyMembersState);
26
29
  // 工具中文名(SSE 首帧 tools_meta)——用户视角只显示这句,不显示声明名。
27
30
  const [toolLabels, setToolLabels] = useState({});
28
31
  const noticeSeq = useRef(0);
@@ -68,6 +71,7 @@ export default function ChatApp({ branding, sessionId, initialMessages, tier, sc
68
71
  setNotices((xs) => [...xs, { ...n, key }]);
69
72
  setTimeout(() => setNotices((xs) => xs.filter((x) => x.key !== key)), 8000);
70
73
  },
74
+ onMember: (ev) => setMembers((prev) => reduceMembers(prev, ev)),
71
75
  }), [onRunEnd]);
72
76
  // A7: thumbs up/down. The official FeedbackAdapter hook gives us the rated
73
77
  // message; the client message id is an opaque ref (the server's own messageId
@@ -95,7 +99,15 @@ export default function ChatApp({ branding, sessionId, initialMessages, tier, sc
95
99
  ...(suggestionAdapter ? { suggestion: suggestionAdapter } : {}),
96
100
  },
97
101
  });
98
- const { FollowUpSuggestions } = useSlots();
102
+ const { FollowUpSuggestions, MemberCards } = useSlots();
103
+ // 成员的展示名:branding 下发的 persona label(只展示字段),id 兜底。
104
+ const memberLabels = useMemo(() => {
105
+ const out = {};
106
+ for (const [id, ui] of Object.entries(branding.personas ?? {}))
107
+ if (ui.label)
108
+ out[id] = ui.label;
109
+ return out;
110
+ }, [branding.personas]);
99
111
  const answerConfirm = useCallback((info, allow) => {
100
112
  setConfirms((c) => c.filter((x) => x.toolCallId !== info.toolCallId));
101
113
  void postDecision({ sessionId: info.sessionId, toolCallId: info.toolCallId, allow }, auth.token);
@@ -160,7 +172,7 @@ export default function ChatApp({ branding, sessionId, initialMessages, tier, sc
160
172
  runtime.thread.cancelRun();
161
173
  };
162
174
  const drop = (i) => setQueue((q) => q.filter((_, j) => j !== i));
163
- return (_jsx(AssistantRuntimeProvider, { runtime: runtime, children: _jsx(SlotsProvider, { value: slots, children: _jsxs("div", { className: "chat", children: [_jsxs("header", { className: "chatbar", children: [branding.logo ? _jsx("img", { className: "logo", src: branding.logo, alt: "" }) : null, _jsx("h1", { children: title ?? branding.title }), _jsx(ThemeToggle, {})] }), policyNote && (_jsxs("p", { className: "policy-bar", role: "note", children: [_jsx("span", { className: "policy-dot", "aria-hidden": "true", children: "i" }), _jsx("span", { children: policyNote })] })), _jsxs(ThreadPrimitive.Root, { className: "thread", children: [_jsxs("div", { className: "thread-wrap", children: [_jsxs(ThreadPrimitive.Viewport, { className: "viewport", children: [_jsx(ThreadPrimitive.Empty, { children: _jsxs("div", { className: "welcome", children: [_jsx("p", { children: welcome ?? branding.welcome ?? "有什么可以帮你?" }), (suggestions ?? branding.suggestions ?? []).map((s) => (_jsx("button", { className: "chip", onClick: () => send(s), children: s }, s)))] }) }), _jsx(ToolLabels.Provider, { value: toolLabels, children: _jsx(CardRenderer.Provider, { value: renderCard ?? (() => null), children: _jsx(ThreadPrimitive.Messages, { components: { UserMessage, UserEditComposer, AssistantMessage } }) }) }), _jsx(AuiIf, { condition: (s) => s.thread.isRunning, children: _jsx(RunningIndicator, {}) })] }), _jsx(ThreadPrimitive.ScrollToBottom, { className: "scroll-bottom", title: "\u6EDA\u52A8\u5230\u6700\u65B0", children: "\u2193" })] }), _jsx(FollowUpSuggestions, {}), confirms.length > 0 && (_jsx("div", { className: "confirms", children: confirms.map((c) => (_jsx(ConfirmCard, { request: c, onAnswer: (allow) => answerConfirm(c, allow) }, c.toolCallId))) })), notices.length > 0 && (_jsx("div", { className: "notices", children: notices.map((n) => (_jsx("div", { className: `notice ${n.level}`, children: n.message }, n.key))) })), uiPrompts.length > 0 && (_jsx("div", { className: "confirms", children: uiPrompts.map((p) => (_jsx(UIPromptCard, { prompt: p, onAnswer: (a) => answerUI(p, a) }, p.id))) })), queue.length > 0 && _jsx(QueueBar, { queue: queue, onSteer: steer, onDrop: drop }), usage && (_jsxs("div", { className: "statusbar", children: ["\u672C\u6B21\u7528\u91CF ", usage.total, " tokens\uFF08\u8F93\u5165 ", usage.input, " / \u8F93\u51FA ", usage.output, "\uFF09"] })), _jsx(Composer, { running: running, commands: commands, tiers: branding.tiers, tier: tier, onTier: onTier, onSend: send, attachIconSpec: branding.ui?.icons?.attachment, onStop: () => runtime.thread.cancelRun() }), _jsx(Lightbox, {})] })] }) }) }));
175
+ return (_jsx(AssistantRuntimeProvider, { runtime: runtime, children: _jsx(SlotsProvider, { value: slots, children: _jsxs("div", { className: "chat", children: [_jsxs("header", { className: "chatbar", children: [branding.logo ? _jsx("img", { className: "logo", src: branding.logo, alt: "" }) : null, _jsx("h1", { children: title ?? branding.title }), _jsx(ThemeToggle, {})] }), policyNote && (_jsxs("p", { className: "policy-bar", role: "note", children: [_jsx("span", { className: "policy-dot", "aria-hidden": "true", children: "i" }), _jsx("span", { children: policyNote })] })), _jsxs(ThreadPrimitive.Root, { className: "thread", children: [_jsxs("div", { className: "thread-wrap", children: [_jsxs(ThreadPrimitive.Viewport, { className: "viewport", children: [_jsx(ThreadPrimitive.Empty, { children: _jsxs("div", { className: "welcome", children: [_jsx("p", { children: welcome ?? branding.welcome ?? "有什么可以帮你?" }), (suggestions ?? branding.suggestions ?? []).map((s) => (_jsx("button", { className: "chip", onClick: () => send(s), children: s }, s)))] }) }), _jsx(ToolLabels.Provider, { value: toolLabels, children: _jsx(CardRenderer.Provider, { value: renderCard ?? (() => null), children: _jsx(ThreadPrimitive.Messages, { components: { UserMessage, UserEditComposer, AssistantMessage } }) }) }), _jsx(AuiIf, { condition: (s) => s.thread.isRunning, children: _jsx(RunningIndicator, {}) })] }), _jsx(ThreadPrimitive.ScrollToBottom, { className: "scroll-bottom", title: "\u6EDA\u52A8\u5230\u6700\u65B0", children: "\u2193" })] }), _jsx(FollowUpSuggestions, {}), confirms.length > 0 && (_jsx("div", { className: "confirms", children: confirms.map((c) => (_jsx(ConfirmCard, { request: c, onAnswer: (allow) => answerConfirm(c, allow) }, c.toolCallId))) })), notices.length > 0 && (_jsx("div", { className: "notices", children: notices.map((n) => (_jsx("div", { className: `notice ${n.level}`, children: n.message }, n.key))) })), _jsx(MemberCards, { members: members.members, labels: memberLabels }), uiPrompts.length > 0 && (_jsx("div", { className: "confirms", children: uiPrompts.map((p) => (_jsx(UIPromptCard, { prompt: p, onAnswer: (a) => answerUI(p, a) }, p.id))) })), queue.length > 0 && _jsx(QueueBar, { queue: queue, onSteer: steer, onDrop: drop }), usage && (_jsxs("div", { className: "statusbar", children: ["\u672C\u6B21\u7528\u91CF ", usage.total, " tokens\uFF08\u8F93\u5165 ", usage.input, " / \u8F93\u51FA ", usage.output, "\uFF09"] })), _jsx(Composer, { running: running, commands: commands, tiers: branding.tiers, tier: tier, onTier: onTier, onSend: send, attachIconSpec: branding.ui?.icons?.attachment, onStop: () => runtime.thread.cancelRun() }), _jsx(Lightbox, {})] })] }) }) }));
164
176
  }
165
177
  /** Shown while a run is streaming: animated dots + seconds since this run's
166
178
  * indicator mounted (unmount/remount per run resets the counter by design). */
package/dist/adapter.d.ts CHANGED
@@ -32,6 +32,11 @@ export interface ChatBridge {
32
32
  onUiPrompt(prompt: UiPromptEvent): void;
33
33
  /** An extension sent a notification; show it, no answer expected. */
34
34
  onUiNotify(note: UiNotifyEvent): void;
35
+ /**
36
+ * 多 phase 的成员事件(W4)。缺省 = 旧前端完全不消费成员视图——平台加事件、
37
+ * 产品不接也不会崩(降级契约)。传了就逐帧交给 `reduceMembers`。
38
+ */
39
+ onMember?(ev: MemberEvent): void;
35
40
  }
36
41
  /** Mark the next run as an edit. Call it before the composer sends. */
37
42
  export declare function markEdit(): void;
@@ -43,6 +48,10 @@ export type UiPromptEvent = Extract<ChatEvent, {
43
48
  export type UiNotifyEvent = Extract<ChatEvent, {
44
49
  type: "ui_notify";
45
50
  }>;
51
+ /** 多 phase 的成员/Run 级事件,交给 ChatBridge 归集成成员卡片(W4)。 */
52
+ export type MemberEvent = Extract<ChatEvent, {
53
+ type: "member_started" | "member_delta" | "member_done" | "run_done";
54
+ }>;
46
55
  /**
47
56
  * Bridges our SSE wire protocol to assistant-ui's ChatModelAdapter.
48
57
  *
package/dist/adapter.js CHANGED
@@ -216,10 +216,25 @@ export function createChatAdapter(bridge) {
216
216
  case "ui_notify":
217
217
  bridge.onUiNotify(ev);
218
218
  continue;
219
+ case "member_started":
220
+ case "member_delta":
221
+ case "member_done":
222
+ case "run_done":
223
+ // 多 phase 的成员/Run 事件:交给成员视图归集,不进主气泡 parts。
224
+ // 旧 bridge 没传 onMember 时静默丢弃——这就是降级契约(不崩、不污染气泡)。
225
+ bridge.onMember?.(ev);
226
+ // 多 phase 不发 `done`(收口语义由 run_done 承担),状态栏用量在这里补上。
227
+ if (ev.type === "run_done")
228
+ usage ??= ev.usage;
229
+ continue;
219
230
  case "done":
220
231
  usage ??= ev.usage;
221
232
  aborted = ev.aborted;
222
233
  continue;
234
+ default:
235
+ // 降级契约显式化:平台未来新增的事件类型,旧前端安全忽略——
236
+ // 不 throw、不往 parts 塞东西(那会污染回答气泡)。
237
+ continue;
223
238
  }
224
239
  chunks++;
225
240
  yield { content: [...parts], metadata: { timing: snapshot() } };
package/dist/styles.css CHANGED
@@ -275,6 +275,19 @@ body {
275
275
  .notice.warning { background: color-mix(in srgb, var(--ac-warn) 20%, var(--ac-card)); }
276
276
  .notice.error { background: color-mix(in srgb, var(--ac-danger) 16%, var(--ac-card)); }
277
277
 
278
+ /* 多 phase 成员卡片(W4):一张卡一个成员,各自流式文本与 usage。 */
279
+ .members { display: flex; flex-direction: column; gap: 8px; padding: 6px 14px 0; }
280
+ .member { border: 1px solid var(--ac-line); border-radius: var(--ac-radius); padding: 8px var(--ac-pad); background: var(--ac-card); }
281
+ .member-head { display: flex; align-items: center; justify-content: space-between; gap: 8px; }
282
+ .member-name { font-weight: 600; font-size: var(--ac-text-sm); }
283
+ .member-state { font-size: var(--ac-text-xs); color: var(--ac-muted); }
284
+ .member-state.completed { color: var(--ac-ok); }
285
+ .member-state.failed { color: var(--ac-danger); }
286
+ .member-state.running { color: var(--ac-primary); }
287
+ .member-task { font-size: var(--ac-text-xs); color: var(--ac-muted); margin-top: 4px; }
288
+ .member-text { white-space: pre-wrap; font-size: var(--ac-text-sm); margin-top: 6px; }
289
+ .member-usage { font-size: var(--ac-text-xs); color: var(--ac-muted); text-align: right; margin-top: 4px; }
290
+
278
291
  .statusbar { padding: 4px 14px; font-size: var(--ac-text-xs); color: var(--ac-muted); text-align: right; }
279
292
 
280
293
  .composer {
@@ -0,0 +1,15 @@
1
+ /**
2
+ * 多 phase 成员卡片的默认渲染(W4 / R-010,S6)。
3
+ *
4
+ * 纯展示组件:只吃 `reduceMembers` 的快照,不写状态、不碰协议细节。
5
+ * 通过 Slots 的 `MemberCards` 槽可整体换皮——产品换外观不重写归集逻辑。
6
+ * 档 1(单 phase)没有 member_* 事件,`members` 为空 ⇒ 整个组件返回 null,
7
+ * 用户看到的气泡与 W4 之前逐字相同(I8 的前端半边)。
8
+ */
9
+ import type { MemberView } from "./members.ts";
10
+ export interface MemberCardsProps {
11
+ readonly members: readonly MemberView[];
12
+ /** 成员 id → 展示名(来自 branding.personas 的 label);缺省回落到 id。 */
13
+ readonly labels?: Readonly<Record<string, string>>;
14
+ }
15
+ export declare function MemberCards({ members, labels }: MemberCardsProps): import("react").JSX.Element | null;
@@ -0,0 +1,13 @@
1
+ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
2
+ const STATE_LABEL = {
3
+ running: "执行中…",
4
+ completed: "✓ 完成",
5
+ failed: "✗ 失败",
6
+ stopped: "已停止",
7
+ blocked: "⛔ 受限",
8
+ };
9
+ export function MemberCards({ members, labels }) {
10
+ if (members.length === 0)
11
+ return null;
12
+ return (_jsx("div", { className: "members", role: "group", "aria-label": "\u534F\u4F5C\u6210\u5458", children: members.map((m) => (_jsxs("div", { className: `member ${m.state}`, children: [_jsxs("div", { className: "member-head", children: [_jsx("span", { className: "member-name", children: labels?.[m.memberId] ?? m.memberId }), _jsx("span", { className: `member-state ${m.state}`, children: STATE_LABEL[m.state] })] }), m.task && _jsx("div", { className: "member-task", children: m.task }), m.text && _jsx("div", { className: "member-text", children: m.text }), m.usage && (_jsxs("div", { className: "member-usage", children: [m.usage.total, " tokens"] }))] }, `${m.phaseId}\u0000${m.memberId}`))) }));
13
+ }
@@ -0,0 +1,42 @@
1
+ /**
2
+ * 多 phase 的成员卡片归集(W4 / R-010,S6):把 SSE 的 `member_*` / `run_done`
3
+ * 事件流折成「谁在跑、各自说了什么、各自花了多少」的状态。
4
+ *
5
+ * 为什么是纯 reducer 而不是塞进 React state:
6
+ * ① 归集逻辑(乱序 done、delta 拼接、runId 切换时重置)是本次最该被测的东西,
7
+ * 纯函数能在**原生 loader**下测(web 测试默认不走 tsx,见 test-stable.mjs);
8
+ * ② adapter.ts 只负责把协议事件分发到 bridge,不认识 UI 形状;
9
+ * ③ UI 组件只渲染快照,不写状态机——与 ConfirmCard / QueueBar 同构。
10
+ *
11
+ * 降级契约:任何不认识的事件类型进 `reduceMembers` 都被安全忽略(返回原状态),
12
+ * 绝不 throw、绝不往成员卡片里塞垃圾。这样平台将来加事件,旧前端不会崩。
13
+ */
14
+ import type { ChatEvent, TokenUsage } from "@njuptlzf/agent-chat-protocol";
15
+ /** 一个成员的视图状态。 */
16
+ export interface MemberView {
17
+ readonly memberId: string;
18
+ readonly phaseId: string;
19
+ /** running / completed / failed / stopped / blocked。 */
20
+ readonly state: "running" | "completed" | "failed" | "stopped" | "blocked";
21
+ /** 这个成员流式吐出的全部文本(delta 依次拼接)。 */
22
+ readonly text: string;
23
+ /** 交给它的任务文本(member_started 时带)。 */
24
+ readonly task: string;
25
+ /** 该成员自己的 usage;未收口时为空。 */
26
+ readonly usage: TokenUsage | undefined;
27
+ }
28
+ /** 一次 multi-phase Run 的视图快照。 */
29
+ export interface MembersState {
30
+ /** 当前 runId;切换 Run 时整组重置。 */
31
+ readonly runId: string | undefined;
32
+ readonly members: readonly MemberView[];
33
+ /** Run 收口(run_done)。 */
34
+ readonly done: boolean;
35
+ /** Run 级 usage(run_done 带)。 */
36
+ readonly usage: TokenUsage | undefined;
37
+ }
38
+ export declare const emptyMembersState: MembersState;
39
+ /**
40
+ * 折一个事件进状态。**纯函数**:不修改 prev,返回新对象(未命中时原样返回 prev)。
41
+ */
42
+ export declare function reduceMembers(prev: MembersState, ev: ChatEvent): MembersState;
@@ -0,0 +1,53 @@
1
+ export const emptyMembersState = { runId: undefined, members: [], done: false, usage: undefined };
2
+ const zeroUsage = { input: 0, output: 0, cacheRead: 0, cacheWrite: 0, total: 0, costUsd: 0 };
3
+ function isMemberState(s) {
4
+ return s === "running" || s === "completed" || s === "failed" || s === "stopped" || s === "blocked";
5
+ }
6
+ /**
7
+ * 折一个事件进状态。**纯函数**:不修改 prev,返回新对象(未命中时原样返回 prev)。
8
+ */
9
+ export function reduceMembers(prev, ev) {
10
+ // 只处理编排事件;其余一律安全忽略(降级契约)。
11
+ if (ev.type !== "member_started" &&
12
+ ev.type !== "member_delta" &&
13
+ ev.type !== "member_done" &&
14
+ ev.type !== "run_done") {
15
+ return prev;
16
+ }
17
+ // 换 Run 重置:一个 session 里可以连续跑多个 flow,每组成员互不串台。
18
+ const base = prev.runId === undefined || prev.runId === ev.runId ? prev : emptyMembersState;
19
+ if (ev.type === "run_done") {
20
+ return { ...base, runId: ev.runId, done: true, usage: ev.usage };
21
+ }
22
+ const key = (m) => `${m.memberId}\u0000${m.phaseId}`;
23
+ const id = `${ev.memberId}\u0000${ev.phaseId}`;
24
+ const at = base.members.findIndex((m) => key(m) === id);
25
+ if (ev.type === "member_started") {
26
+ // started 可能晚于 delta(乱序)或重复到达:保留已有的 text/usage,只刷新
27
+ // task 与状态为 running。绝不用空串覆盖已经收到的字。
28
+ const next = {
29
+ memberId: ev.memberId,
30
+ phaseId: ev.phaseId,
31
+ state: "running",
32
+ text: at === -1 ? "" : base.members[at].text,
33
+ task: ev.task,
34
+ usage: at === -1 ? undefined : base.members[at].usage,
35
+ };
36
+ const members = at === -1 ? [...base.members, next] : base.members.map((m, i) => (i === at ? next : m));
37
+ return { ...base, runId: ev.runId, members };
38
+ }
39
+ // delta / done 若在 started 之前到达(乱序),建一个占位成员再更新——
40
+ // 前端不该因为服务端事件顺序抖动就丢字。
41
+ const cur = at === -1
42
+ ? { memberId: ev.memberId, phaseId: ev.phaseId, state: "running", text: "", task: "", usage: undefined }
43
+ : base.members[at];
44
+ const updated = ev.type === "member_delta"
45
+ ? { ...cur, text: cur.text + ev.delta }
46
+ : {
47
+ ...cur,
48
+ state: isMemberState(ev.state) ? ev.state : "failed",
49
+ usage: ev.usage ?? zeroUsage,
50
+ };
51
+ const members = at === -1 ? [...base.members, updated] : base.members.map((m, i) => (i === at ? updated : m));
52
+ return { ...base, runId: ev.runId, members };
53
+ }
@@ -1,4 +1,5 @@
1
1
  import { type ComponentType } from "react";
2
+ import { type MemberCardsProps } from "./MemberCards.tsx";
2
3
  export interface IconProps {
3
4
  /** 图标值(`branding.ui.icons` 里该槽的字符串);缺省回落内置矢量。 */
4
5
  spec?: string;
@@ -15,6 +16,11 @@ export interface IconProps {
15
16
  export interface Slots {
16
17
  Icon: ComponentType<IconProps>;
17
18
  FollowUpSuggestions: ComponentType;
19
+ /**
20
+ * 多 phase 成员卡片视图(W4)。产品可整体换皮;默认实现消费 `reduceMembers`
21
+ * 的快照。档 1 传空数组 ⇒ 默认实现返回 null,零 DOM、零视觉变化。
22
+ */
23
+ MemberCards: ComponentType<MemberCardsProps>;
18
24
  }
19
25
  export declare const defaultSlots: Slots;
20
26
  export declare const SlotsProvider: import("react").Provider<Slots>;
package/dist/ui/slots.js CHANGED
@@ -1,7 +1,8 @@
1
1
  import { createContext, useContext } from "react";
2
2
  import { Icon } from "./Icon.js";
3
3
  import { FollowUpSuggestions } from "./FollowUpSuggestions.js";
4
- export const defaultSlots = { Icon, FollowUpSuggestions };
4
+ import { MemberCards } from "./MemberCards.js";
5
+ export const defaultSlots = { Icon, FollowUpSuggestions, MemberCards };
5
6
  const SlotsContext = createContext(defaultSlots);
6
7
  export const SlotsProvider = SlotsContext.Provider;
7
8
  export function useSlots() {
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@njuptlzf/agent-chat-web",
3
- "version": "0.3.0",
3
+ "version": "0.4.1",
4
4
  "description": "Business-agnostic web chat shell for agentChat products: AgentApp mount, AppDef contract, host panels and HTTP helpers.",
5
5
  "type": "module",
6
6
  "license": "Apache-2.0",
@@ -38,7 +38,7 @@
38
38
  "vite"
39
39
  ],
40
40
  "engines": {
41
- "node": ">=22.13"
41
+ "node": ">=22.15"
42
42
  },
43
43
  "publishConfig": {
44
44
  "access": "public"
@@ -50,7 +50,7 @@
50
50
  "preview": "vite preview"
51
51
  },
52
52
  "dependencies": {
53
- "@njuptlzf/agent-chat-protocol": "^0.3.0",
53
+ "@njuptlzf/agent-chat-protocol": "^0.4.0",
54
54
  "@assistant-ui/react": "^0.15.28",
55
55
  "@assistant-ui/react-markdown": "^0.14.22",
56
56
  "exceljs": "^4.4.0",
@@ -18,7 +18,8 @@ import {
18
18
  type ToolCallMessagePartProps,
19
19
  } from "@assistant-ui/react";
20
20
  import { MarkdownTextPrimitive } from "@assistant-ui/react-markdown";
21
- import { createChatAdapter, dataUrlToImage, markEdit, type UiNotifyEvent, type UiPromptEvent } from "./adapter.ts";
21
+ import { createChatAdapter, dataUrlToImage, markEdit, type MemberEvent, type UiNotifyEvent, type UiPromptEvent } from "./adapter.ts";
22
+ import { emptyMembersState, reduceMembers, type MembersState } from "./ui/members.ts";
22
23
  import { createFollowUpAdapter, followUpConfigOf, resolveFollowUpMode } from "./suggestions.ts";
23
24
  import { docKind, docPart, fileToDoc, MAX_DOCS, type DocEntry } from "./docs.ts";
24
25
  import { auth } from "./auth.ts";
@@ -85,6 +86,8 @@ export default function ChatApp({
85
86
  const [confirms, setConfirms] = useState<ConfirmRequest[]>([]);
86
87
  const [uiPrompts, setUiPrompts] = useState<UiPromptEvent[]>([]);
87
88
  const [notices, setNotices] = useState<(UiNotifyEvent & { key: number })[]>([]);
89
+ // 多 phase 成员卡片(W4):member_* / run_done 事件逐帧归集;档 1 恒为 emptyMembersState。
90
+ const [members, setMembers] = useState<MembersState>(emptyMembersState);
88
91
  // 工具中文名(SSE 首帧 tools_meta)——用户视角只显示这句,不显示声明名。
89
92
  const [toolLabels, setToolLabels] = useState<Record<string, string>>({});
90
93
  const noticeSeq = useRef(0);
@@ -133,6 +136,7 @@ export default function ChatApp({
133
136
  setNotices((xs) => [...xs, { ...n, key }]);
134
137
  setTimeout(() => setNotices((xs) => xs.filter((x) => x.key !== key)), 8000);
135
138
  },
139
+ onMember: (ev: MemberEvent) => setMembers((prev) => reduceMembers(prev, ev)),
136
140
  }),
137
141
  [onRunEnd],
138
142
  );
@@ -171,7 +175,13 @@ export default function ChatApp({
171
175
  ...(suggestionAdapter ? { suggestion: suggestionAdapter } : {}),
172
176
  },
173
177
  });
174
- const { FollowUpSuggestions } = useSlots();
178
+ const { FollowUpSuggestions, MemberCards } = useSlots();
179
+ // 成员的展示名:branding 下发的 persona label(只展示字段),id 兜底。
180
+ const memberLabels = useMemo(() => {
181
+ const out: Record<string, string> = {};
182
+ for (const [id, ui] of Object.entries(branding.personas ?? {})) if (ui.label) out[id] = ui.label;
183
+ return out;
184
+ }, [branding.personas]);
175
185
 
176
186
  const answerConfirm = useCallback((info: ConfirmRequest, allow: boolean) => {
177
187
  setConfirms((c) => c.filter((x) => x.toolCallId !== info.toolCallId));
@@ -316,6 +326,8 @@ export default function ChatApp({
316
326
  ))}
317
327
  </div>
318
328
  )}
329
+ {/* 多 phase 成员卡片(W4):档 1 无 member_* 事件 ⇒ members 为空 ⇒ 默认槽返回 null。 */}
330
+ <MemberCards members={members.members} labels={memberLabels} />
319
331
  {uiPrompts.length > 0 && (
320
332
  <div className="confirms">
321
333
  {uiPrompts.map((p) => (
@@ -1,74 +1,74 @@
1
- import type { ReactNode } from "react";
2
- import { dockStore, reopenMode, useDockMode, type DockMode } from "./dock.ts";
3
-
4
- /**
5
- * 聊天坞(agentChat Dock):把对话做成一个"能力",挂在任何业务页右边。
6
- *
7
- * 三种形态由 `dock.ts` 的状态机决定:
8
- * docked 挤压内容区(宽屏默认)
9
- * floating 悬浮在内容区右下角,不改布局
10
- * closed 收成右缘竖排唤回按钮(面板用 display:none 藏起来而不是卸载——
11
- * 对话流、滚动位置、会话视图都要在开关之间活着)
12
- *
13
- * `full=true` 是「对话」路由:坞撑满内容区,业务页不渲染。
14
- */
15
- export default function Dock({
16
- chat,
17
- full = false,
18
- onClose,
19
- title = "助手",
20
- children,
21
- }: {
22
- /** 对话组件(只挂一份,开关形态之间不重挂)。 */
23
- chat: ReactNode;
24
- full?: boolean;
25
- /** 坞的标题:换人格时这里也要换,否则点了「声明人格」还写着「默认助手」。 */
26
- title?: string;
27
- /** 聊天路由下点收起:由宿主决定退到哪个业务页。 */
28
- onClose?: () => void;
29
- children?: ReactNode;
30
- }) {
31
- const mode = useDockMode();
32
- const shown: DockMode | "full" = full ? "full" : mode;
33
-
34
- const close = () => {
35
- dockStore.setMode("closed");
36
- onClose?.();
37
- };
38
-
39
- return (
40
- <div className={`dock-wrap ${shown}`}>
41
- {!full && <main className="content">{children}</main>}
42
- <aside className={`dock-pane${mode === "closed" && !full ? " gone" : ""}`} aria-label={title}>
43
- <div className="dock-head">
44
- <span className="dock-title">{title}</span>
45
- {full ? null : (
46
- <button
47
- className="dock-btn"
48
- onClick={() => dockStore.setMode(mode === "floating" ? "docked" : "floating")}
49
- title={mode === "floating" ? "停靠到右侧" : "改为悬浮"}
50
- aria-label={mode === "floating" ? "停靠到右侧" : "改为悬浮"}
51
- >
52
- {mode === "floating" ? "⇥" : "⤢"}
53
- </button>
54
- )}
55
- <button className="dock-btn" onClick={close} title={`收起${title}`} aria-label={`收起${title}`}>
56
- »
57
- </button>
58
- </div>
59
- <div className="dock-body">{chat}</div>
60
- </aside>
61
- {mode === "closed" && !full && (
62
- <button
63
- className="side-open dock-open"
64
- onClick={() => dockStore.setMode(reopenMode(mode, dockStore.lastOpen(), window.innerWidth > 1100))}
65
- title={`打开${title}`}
66
- aria-label={`打开${title}`}
67
- >
68
- <span className="side-open-arrow">«</span>
69
- <span className="side-open-text">{title}</span>
70
- </button>
71
- )}
72
- </div>
73
- );
1
+ import type { ReactNode } from "react";
2
+ import { dockStore, reopenMode, useDockMode, type DockMode } from "./dock.ts";
3
+
4
+ /**
5
+ * 聊天坞(agentChat Dock):把对话做成一个"能力",挂在任何业务页右边。
6
+ *
7
+ * 三种形态由 `dock.ts` 的状态机决定:
8
+ * docked 挤压内容区(宽屏默认)
9
+ * floating 悬浮在内容区右下角,不改布局
10
+ * closed 收成右缘竖排唤回按钮(面板用 display:none 藏起来而不是卸载——
11
+ * 对话流、滚动位置、会话视图都要在开关之间活着)
12
+ *
13
+ * `full=true` 是「对话」路由:坞撑满内容区,业务页不渲染。
14
+ */
15
+ export default function Dock({
16
+ chat,
17
+ full = false,
18
+ onClose,
19
+ title = "助手",
20
+ children,
21
+ }: {
22
+ /** 对话组件(只挂一份,开关形态之间不重挂)。 */
23
+ chat: ReactNode;
24
+ full?: boolean;
25
+ /** 坞的标题:换人格时这里也要换,否则点了「声明人格」还写着「默认助手」。 */
26
+ title?: string;
27
+ /** 聊天路由下点收起:由宿主决定退到哪个业务页。 */
28
+ onClose?: () => void;
29
+ children?: ReactNode;
30
+ }) {
31
+ const mode = useDockMode();
32
+ const shown: DockMode | "full" = full ? "full" : mode;
33
+
34
+ const close = () => {
35
+ dockStore.setMode("closed");
36
+ onClose?.();
37
+ };
38
+
39
+ return (
40
+ <div className={`dock-wrap ${shown}`}>
41
+ {!full && <main className="content">{children}</main>}
42
+ <aside className={`dock-pane${mode === "closed" && !full ? " gone" : ""}`} aria-label={title}>
43
+ <div className="dock-head">
44
+ <span className="dock-title">{title}</span>
45
+ {full ? null : (
46
+ <button
47
+ className="dock-btn"
48
+ onClick={() => dockStore.setMode(mode === "floating" ? "docked" : "floating")}
49
+ title={mode === "floating" ? "停靠到右侧" : "改为悬浮"}
50
+ aria-label={mode === "floating" ? "停靠到右侧" : "改为悬浮"}
51
+ >
52
+ {mode === "floating" ? "⇥" : "⤢"}
53
+ </button>
54
+ )}
55
+ <button className="dock-btn" onClick={close} title={`收起${title}`} aria-label={`收起${title}`}>
56
+ »
57
+ </button>
58
+ </div>
59
+ <div className="dock-body">{chat}</div>
60
+ </aside>
61
+ {mode === "closed" && !full && (
62
+ <button
63
+ className="side-open dock-open"
64
+ onClick={() => dockStore.setMode(reopenMode(mode, dockStore.lastOpen(), window.innerWidth > 1100))}
65
+ title={`打开${title}`}
66
+ aria-label={`打开${title}`}
67
+ >
68
+ <span className="side-open-arrow">«</span>
69
+ <span className="side-open-text">{title}</span>
70
+ </button>
71
+ )}
72
+ </div>
73
+ );
74
74
  }
@@ -76,6 +76,11 @@ export interface ChatBridge {
76
76
  onUiPrompt(prompt: UiPromptEvent): void;
77
77
  /** An extension sent a notification; show it, no answer expected. */
78
78
  onUiNotify(note: UiNotifyEvent): void;
79
+ /**
80
+ * 多 phase 的成员事件(W4)。缺省 = 旧前端完全不消费成员视图——平台加事件、
81
+ * 产品不接也不会崩(降级契约)。传了就逐帧交给 `reduceMembers`。
82
+ */
83
+ onMember?(ev: MemberEvent): void;
79
84
  }
80
85
 
81
86
  /**
@@ -101,6 +106,8 @@ type ToolCallPart = Extract<ThreadAssistantMessagePart, { type: "tool-call" }>;
101
106
  export type UiPromptEvent = Extract<ChatEvent, { type: "ui_prompt" }>;
102
107
  /** A fire-and-forget `ctx.ui.notify` from an extension. */
103
108
  export type UiNotifyEvent = Extract<ChatEvent, { type: "ui_notify" }>;
109
+ /** 多 phase 的成员/Run 级事件,交给 ChatBridge 归集成成员卡片(W4)。 */
110
+ export type MemberEvent = Extract<ChatEvent, { type: "member_started" | "member_delta" | "member_done" | "run_done" }>;
104
111
 
105
112
  /**
106
113
  * Bridges our SSE wire protocol to assistant-ui's ChatModelAdapter.
@@ -246,10 +253,24 @@ export function createChatAdapter(bridge: ChatBridge): ChatModelAdapter {
246
253
  case "ui_notify":
247
254
  bridge.onUiNotify(ev);
248
255
  continue;
256
+ case "member_started":
257
+ case "member_delta":
258
+ case "member_done":
259
+ case "run_done":
260
+ // 多 phase 的成员/Run 事件:交给成员视图归集,不进主气泡 parts。
261
+ // 旧 bridge 没传 onMember 时静默丢弃——这就是降级契约(不崩、不污染气泡)。
262
+ bridge.onMember?.(ev);
263
+ // 多 phase 不发 `done`(收口语义由 run_done 承担),状态栏用量在这里补上。
264
+ if (ev.type === "run_done") usage ??= ev.usage;
265
+ continue;
249
266
  case "done":
250
267
  usage ??= ev.usage;
251
268
  aborted = ev.aborted;
252
269
  continue;
270
+ default:
271
+ // 降级契约显式化:平台未来新增的事件类型,旧前端安全忽略——
272
+ // 不 throw、不往 parts 塞东西(那会污染回答气泡)。
273
+ continue;
253
274
  }
254
275
  chunks++;
255
276
  yield { content: [...parts], metadata: { timing: snapshot() } };